home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_gnats.idb / usr / freeware / catman / u_man / cat1 / query-pr.Z / query-pr
Encoding:
Text File  |  1999-04-16  |  14.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      qqqquuuueeeerrrryyyy----pppprrrr((((1111))))     GGGGNNNNAAAATTTTSSSS 3333....2222 ((((OOOOccccttttoooobbbbeeeerrrr 1111999999993333))))       qqqquuuueeeerrrryyyy----pppprrrr((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       query-pr - query problem reports in the GGGGNNNNAAAATTTTSSSS    database
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       qqqquuuueeeerrrryyyy----pppprrrr
  13.            [ ----cccc _c_a_t_e_g_o_r_y |||| --------ccccaaaatttteeeeggggoooorrrryyyy====_c_a_t_e_g_o_r_y ]
  14.            [ ----ssss _s_t_a_t_e |||| --------ssssttttaaaatttteeee====_s_t_a_t_e ]
  15.            [ ----rrrr _r_e_s_p_o_n_s_i_b_l_e    |||| --------rrrreeeessssppppoooonnnnssssiiiibbbblllleeee====_r_e_s_p_o_n_s_i_b_l_e ]
  16.            [ ----SSSS _s_u_b_m_i_t_t_e_r ||||    --------ssssuuuubbbbmmmmiiiitttttttteeeerrrr====_s_u_b_m_i_t_t_e_r ]
  17.            [ ----CCCC [[[[_y_e_s||||_n_o]]]] |||| --------ccccoooonnnnffffiiiiddddeeeennnnttttiiiiaaaallll[[[[====_y_e_s||||_n_o]]]] ]
  18.            [ ----eeee _s_e_v_e_r_i_t_y |||| --------sssseeeevvvveeeerrrriiiittttyyyy====_s_e_v_e_r_i_t_y ]
  19.            [ ----pppp _p_r_i_o_r_i_t_y |||| --------pppprrrriiiioooorrrriiiittttyyyy====_p_r_i_o_r_i_t_y ]
  20.            [ ----OOOO _n_a_m_e |||| --------oooorrrriiiiggggiiiinnnnaaaattttoooorrrr====_n_a_m_e ]
  21.            [ ----tttt _t_e_x_t |||| --------tttteeeexxxxtttt====_t_e_x_t ]
  22.            [ ----mmmm _t_e_x_t |||| --------mmmmuuuullllttttiiiitttteeeexxxxtttt====_t_e_x_t ]
  23.            [ ----RRRR |||| --------rrrreeeessssttttrrrriiiicccctttteeeedddd ]
  24.            [ ----FFFF |||| --------ffffuuuullllllll ] [ ----qqqq |||| --------ssssuuuummmmmmmmaaaarrrryyyy    ] [ ----iiii |||| --------ssssqqqqllll ]
  25.            [ ----PPPP |||| --------pppprrrriiiinnnntttt----ppppaaaatttthhhh ]
  26.            [ ----dddd _d_i_r_e_c_t_o_r_y ||||    --------ddddiiiirrrreeeeccccttttoooorrrryyyy====_d_i_r_e_c_t_o_r_y ]
  27.            [ ----oooo _o_u_t_f_i_l_e |||| --------oooouuuuttttppppuuuutttt====_o_u_t_f_i_l_e ]
  28.            [ ----VVVV |||| --------vvvveeeerrrrssssiiiioooonnnn    ] [ ----hhhh |||| --------hhhheeeellllpppp    ]
  29.            [ _g_n_a_t_s-_i_d ... ]
  30.  
  31.  
  32.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.       Queries the GGGGNNNNAAAATTTTSSSS database according to options and displays
  34.       Problem Reports on standard output.  If you specify particu-
  35.       lar PR numbers (with the _g_n_a_t_s-_i_d...     arguments),  qqqquuuueeeerrrryyyy----pppprrrr
  36.       restricts its    search to only those PRs.  Using qqqquuuueeeerrrryyyy----pppprrrr with
  37.       no options or    _g_n_a_t_s-_i_d ... arguments displays    a  summary  of
  38.       every    PR in the database.
  39.  
  40.       All options are connected with a logical AAAANNNNDDDD.     For example,
  41.            qqqquuuueeeerrrryyyy----pppprrrr    --------ccccaaaatttteeeeggggoooorrrryyyy====_c_a_t_e_g_o_r_y --------rrrreeeessssppppoooonnnnssssiiiibbbblllleeee====_r_e_s_p_o_n_s_i_b_l_e
  42.       only prints PRs which    have a >>>>CCCCaaaatttteeeeggggoooorrrryyyy::::  field  of  _c_a_t_e_g_o_r_y
  43.       and a    >>>>RRRReeeessssppppoooonnnnssssiiiibbbblllleeee:::: field of _r_e_s_p_o_n_s_i_b_l_e.
  44.  
  45.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  46.       ----cccc _c_a_t_e_g_o_r_y,,,, --------ccccaaaatttteeeeggggoooorrrryyyy====_c_a_t_e_g_o_r_y
  47.            Search  only  for  PRs  with  a    >>>>CCCCaaaatttteeeeggggoooorrrryyyy::::  field   of
  48.            _c_a_t_e_g_o_r_y.
  49.  
  50.       ----ssss _s_t_a_t_e,,,, --------ssssttttaaaatttteeee====_s_t_a_t_e
  51.            Search only for PRs with    a >>>>SSSSttttaaaatttteeee:::: field    of _s_t_a_t_e.
  52.  
  53.       ----rrrr _r_e_s_p_o_n_s_i_b_l_e,,,, --------rrrreeeessssppppoooonnnnssssiiiibbbblllleeee====_r_e_s_p_o_n_s_i_b_l_e
  54.            Search only for    PRs  with  a  >>>>RRRReeeessssppppoooonnnnssssiiiibbbblllleeee::::  field  of
  55.            _r_e_s_p_o_n_s_i_b_l_e.
  56.  
  57.       ----SSSS _s_u_b_m_i_t_t_e_r,,,,    --------ssssuuuubbbbmmmmiiiitttttttteeeerrrr====_s_u_b_m_i_t_t_e_r
  58.            Search only for PRs with    a >>>>SSSSuuuubbbbmmmmiiiitttttttteeeerrrr----IIIIdddd:::: field of _s_u_b_-
  59.            _m_i_t_t_e_r.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 3/19/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      qqqquuuueeeerrrryyyy----pppprrrr((((1111))))     GGGGNNNNAAAATTTTSSSS 3333....2222 ((((OOOOccccttttoooobbbbeeeerrrr 1111999999993333))))       qqqquuuueeeerrrryyyy----pppprrrr((((1111))))
  71.  
  72.  
  73.  
  74.       ----CCCC [[[[_y_e_s||||_n_o]]]],,,, --------ccccoooonnnnffffiiiiddddeeeennnnttttiiiiaaaallll[[[[====_y_e_s||||_n_o]]]]
  75.            Search only for PRs with    a >>>>CCCCoooonnnnffffiiiiddddeeeennnnttttiiiiaaaallll:::: field of  ei-
  76.            ther  _y_e_s  or  _n_o, respectively.     If this option    is not
  77.            given, all PRs will be eligible for the search, regard-
  78.            less of their confidentiality.
  79.  
  80.       ----eeee _s_e_v_e_r_i_t_y,,,, --------sssseeeevvvveeeerrrriiiittttyyyy====_s_e_v_e_r_i_t_y
  81.            Search only for PRs with    a >>>>SSSSeeeevvvveeeerrrriiiittttyyyy:::: field of  _s_e_v_e_r_i_-
  82.            _t_y.
  83.  
  84.       ----pppp _p_r_i_o_r_i_t_y,,,, --------pppprrrriiiioooorrrriiiittttyyyy====_p_r_i_o_r_i_t_y
  85.            Search only for PRs with    a >>>>PPPPrrrriiiioooorrrriiiittttyyyy:::: field of  _p_r_i_o_r_i_-
  86.            _t_y.
  87.  
  88.       ----OOOO _n_a_m_e,,,, --------oooorrrriiiiggggiiiinnnnaaaattttoooorrrr====_n_a_m_e
  89.            Search for _n_a_m_e in the >>>>OOOOrrrriiiiggggiiiinnnnaaaattttoooorrrr:::: field of  each  PR.
  90.            _n_a_m_e  need only be enough to uniquely identify the per-
  91.            son.  For example, to find "Steve Williams", you     could
  92.            use  a  _n_a_m_e  of     "Steve    W".  Use another search    option
  93.            (e.g.  --------ssssttttaaaatttteeee),    to speed the search.  Using ----OOOO by  it-
  94.            self  can  be slow with a large database.  You must en-
  95.            close the name with double-quotes  to  make  sure  your
  96.            shell passes it as a single string, and not as separate
  97.            arguments to qqqquuuueeeerrrryyyy----pppprrrr.
  98.  
  99.       ----tttt _t_e_x_t,,,, --------tttteeeexxxxtttt====_t_e_x_t
  100.            Search single-line text fields in all PRs for the regu-
  101.            lar expression _t_e_x_t.
  102.  
  103.       ----mmmm _t_e_x_t,,,, --------mmmmuuuullllttttiiiitttteeeexxxxtttt====_t_e_x_t
  104.            Search multiple-line text fields    in  all     PRs  for  the
  105.            regular expression _t_e_x_t.
  106.  
  107.       ----RRRR,,,, --------rrrreeeessssttttrrrriiiicccctttteeeedddd
  108.            Omit from the search any    PR marked >>>>CCCCoooonnnnffffiiiiddddeeeennnnttttiiiiaaaallll::::  yyyyeeeessss.
  109.            This  is     equivalent  to     specifying --------ccccoooonnnnffffiiiiddddeeeennnnttttiiiiaaaallll====nnnnoooo.
  110.            This also disallows the use of the options
  111.            --------oooouuuuttttffffiiiilllleeee====_o_u_t_f_i_l_e and --------ddddiiiirrrreeeeccccttttoooorrrryyyy====_d_i_r_e_c_t_o_r_y.
  112.  
  113.       ----FFFF,,,, --------ffffuuuullllllll
  114.            Prints the full Problem Report rather than just a  sum-
  115.            mary.
  116.  
  117.       ----qqqq,,,, --------ssssuuuummmmmmmmaaaarrrryyyy
  118.            Give a short summary line for PRs.
  119.  
  120.       ----iiii,,,, --------ssssqqqqllll
  121.            Prints data in a    format readable    by a relational     data-
  122.            base (see the GNATS manual _K_e_e_p_i_n_g _T_r_a_c_k    for a full ex-
  123.            planation).
  124.  
  125.       ----PPPP,,,, --------pppprrrriiiinnnntttt----ppppaaaatttthhhh
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 3/19/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      qqqquuuueeeerrrryyyy----pppprrrr((((1111))))     GGGGNNNNAAAATTTTSSSS 3333....2222 ((((OOOOccccttttoooobbbbeeeerrrr 1111999999993333))))       qqqquuuueeeerrrryyyy----pppprrrr((((1111))))
  137.  
  138.  
  139.  
  140.            Print the path used to find each    PR.
  141.  
  142.       ----dddd _d_i_r_e_c_t_o_r_y,,,,    --------ddddiiiirrrreeeeccccttttoooorrrryyyy====_d_i_r_e_c_t_o_r_y
  143.            Changes the search directory to _d_i_r_e_c_t_o_r_y.
  144.  
  145.       ----oooo _o_u_t_f_i_l_e,,,, --------oooouuuuttttppppuuuutttt====_o_u_t_f_i_l_e
  146.            Print all output    to _o_u_t_f_i_l_e rather than to the standard
  147.            output.
  148.  
  149.       ----VVVV,,,, --------vvvveeeerrrrssssiiiioooonnnn
  150.            Prints the version number of qqqquuuueeeerrrryyyy----pppprrrr.
  151.  
  152.       ----hhhh,,,, --------hhhheeeellllpppp
  153.            Prints a    brief usage summary.
  154.  
  155.      QQQQUUUUEEEERRRRYYYY BBBBYYYY MMMMAAAAIIIILLLL
  156.       qqqquuuueeeerrrryyyy----pppprrrr can also be accessed    by electronic  mail,  if  your
  157.       version  of  GNATS  is  configured  for  this.   To use this
  158.       feature, simply send mail to the address  qqqquuuueeeerrrryyyy----pppprrrr@@@@_y_o_u_r-_s_i_t_e
  159.       with    command    line arguments or options in the SSSSuuuubbbbjjjjeeeecccctttt:::: line
  160.       of the mail header.  GNATS replies to     your  mail  with  the
  161.       results  of your query.  The default settings    for the    qqqquuuueeeerrrryyyy----
  162.       pppprrrr mail server are shown  below;  to    override  the  --------ssssttttaaaatttteeee
  163.       parameter, specify --------ssssttttaaaatttteeee====_s_t_a_t_e in the SSSSuuuubbbbjjjjeeeecccctttt:::: line    of the
  164.       mail header.    You can    not query on confidential Problem  Re-
  165.       ports    by mail.
  166.  
  167.       --------rrrreeeessssttttrrrriiiicccctttteeeedddd --------ssssttttaaaatttteeee====""""ooooppppeeeennnn||||aaaannnnaaaallllyyyyzzzzeeeedddd||||ffffeeeeeeeeddddbbbbaaaacccckkkk||||ssssuuuussssppppeeeennnnddddeeeedddd""""
  168.  
  169.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  170.       _K_e_e_p_i_n_g _T_r_a_c_k: _M_a_n_a_g_i_n_g _M_e_s_s_a_g_e_s _W_i_t_h    _G_N_A_T_S (also  installed
  171.       as  the GNU Info file    ggggnnnnaaaattttssss....iiiinnnnffffoooo) and    _R_e_p_o_r_t_i_n_g _P_r_o_b_l_e_m_s _U_s_-
  172.       _i_n_g _s_e_n_d-_p_r (also installed  as  the    GNU  Info  file     sssseeeennnndddd----
  173.       pppprrrr....iiiinnnnffffoooo).
  174.  
  175.       ggggnnnnaaaattttssss(l), sssseeeennnndddd----pppprrrr(1),    eeeeddddiiiitttt----pppprrrr(1),  ffffiiiilllleeee----pppprrrr(8),  qqqquuuueeeeuuuueeee----pppprrrr(8),
  176.       mmmmkkkkccccaaaatttt(8), rrrrmmmmccccaaaatttt(8), ggggeeeennnn----iiiinnnnddddeeeexxxx(8), mmmmkkkkddddiiiisssstttt(8).
  177.  
  178.      CCCCOOOOPPPPYYYYIIIINNNNGGGG
  179.       Copyright (c)    1993 Free Software Foundation, Inc.
  180.  
  181.       Permission is    granted    to make    and distribute verbatim    copies
  182.       of  this  manual provided the    copyright notice and this per-
  183.       mission notice are preserved on all copies.
  184.  
  185.       Permission is    granted    to copy    and distribute    modified  ver-
  186.       sions    of this    manual under the conditions for    verbatim copy-
  187.       ing, provided    that the entire    resulting derived work is dis-
  188.       tributed under the terms of a    permission notice identical to
  189.       this one.
  190.  
  191.       Permission is    granted    to copy    and distribute translations of
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 3/19/99)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      qqqquuuueeeerrrryyyy----pppprrrr((((1111))))     GGGGNNNNAAAATTTTSSSS 3333....2222 ((((OOOOccccttttoooobbbbeeeerrrr 1111999999993333))))       qqqquuuueeeerrrryyyy----pppprrrr((((1111))))
  203.  
  204.  
  205.  
  206.       this    manual    into  another language,    under the above    condi-
  207.       tions    for modified versions, except that this    permission no-
  208.       tice    may  be     included in translations approved by the Free
  209.       Software Foundation instead of in the    original English.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 3/19/99)
  262.  
  263.  
  264.  
  265.